                          Virtual Poker Supreme 2K4 v5.0
                                    Copyright (C) 2004
                                               Billy Ella
-----------------------------------------------------------------------------------
Directions:*Send poker.89g  to your calculator
                   *For better memory management, archive 
                    everything except for the program poker() 
                    and zex() until after the games first run.
                   *DO NOT run the program zex().  You will just
                    get an error.
                    *DO NOT delete any files that are in the bevpsv5
                    folder (Virtual Poker will not work!)
                    *DO NOT archive poker() and zex() until after the
                     first run.
                    *Run poker() (be patient the first time, it will
                    take a while).
                    *If you want, you can put poker() in your Main folder or
                    you could rename it to be a "kbd" program. (I suggest
                    you putting it in the main to be with you other games).
                    *If you want to reset your game to "new" then delete
                    the "save" matrix.
-------------------------------------------------------------------------------------------
Description:  This is the most advanced TI-89 poker game to date.
Features Include:  Great Card Graphics
                                Free Play Mode
                                High Score Mode
                                3 Save Files
                                High Scores
                                Money Spent/Gained Tracker
                                An Outcome Tally
                                Other Statistics
                                Earnable Cheats
                                Unlockable Backs
                                The Option To Have A Real Deck
                                1 or 2 Decks To Draw From
                                Wild 2's
                                Jokers
                                A Revolutionary Bet Screen
                                and Much More!
---------------------------------------------------------------------------------------
Game Explanations:
 *Free Play Mode-  Play as much virtual poker as you want 
without betting money or having a turn restriction.  You cannot 
get a high score or use cheats, but the statistics are still tracked.

*Continue A Saved Game-  Continue where you left off with a
High Score Game.
                      
*High Score Mode-  You have five turns to earn as much money
as you can.

*Records-  Go here to see varied statistics including:  
  *High Scores-self-explanatory
  *Outcome Tally-  Keeps track of all your outcomes (e.g. Pair)
  *This Game Opened-  How many times you ran the poker game
  *FPM Hands Played-  How many Free Play Mode hands you
    have played
  *HSM Hands Played-  How many High Score Mode hands you
   have played
  *Credits Spent-How many credits you bet (see scoring for more 
   info about betting)
  *Credits Gained-How many credits you earned (see scoring for
more info about betting)

 *Cheats- There are five.  I won't tell you what they are, but I will say
that you earn them by:
  *Getting the Top Score
  *Running the Game 25 times
  *Playing Free Play Mode 25 times
  *Playing High Score Mode 25 times 
  *and Having 100,000 Chips gained
 After earning a cheat, go to the Cheats menu to turn it ON or OFF
 by pressing the corresponding F button.

*Unlockable Backs-  There are 7 available backs to unlock, and you 
open them by performing these various tasks in game:
  *Running the Game 50 times
  *Playing Free Play Mode 50 times
  *Playing High Score Mode 50 times
  *Get a Royal Flush OR a 5 of a Kind
  *Having 250,000 Chips Gained
  *Having 250,000 Chips Spent
  *and Getting a Score of 5,000,000
After earning a back, goto the APPS menu and select the Back
choice.  Now press the left and right arrows to choose which one
you want to use (a back with a lock means it hasn't been opened
yet).

*Fresh Deck- This choice is made available so you can regenerate
 a new deck.  This choice is only available if "Real Deck" is ON.

*Real Deck-Turn this ON from the Apps menu to play with a real
deck, instead of random cards.

*Number of Decks- If Real Deck is ON then you can choose whether
 to play with 1 or 2 decks available for cards to be drawn from.

*Wild 2's- Turn this ON if you want all the 2's to become wild cards.
  When you get a 2, at the end of play it will flash.  Press enter to then
  choose what number and suit you would like it to become.

*Jokers- Turn this ON if you want Wild Joker's to be available in play.
  When you get a Joker, at the end of play it will flash.  Press enter to
 then choose what number and suit you would like it to become.

*"Max Bet"-  This is an APPS menu option.  This will make it so the
calculator will automatically enter you total money abount into the bet
box (all you have to press is enter).

*Toolbars-Press the F button that shows what you want to 
 do(i.e. Hit).  Press ESC to exit the game or got to the 
 previous screen you were on.

 *New Deck Screen-  I decided to create an all new deck screen,
mainly becuase the Dialog bet screen was annoying becuase you
had to press alpha every single bet and because the altrenate
IO bet screen didn't look that nice.  Enter numbers the same as
you would in a normal bet screen.  Press ESC to exit and APPS
for a menu.  Everything offered by the shortcuts/special bets in the
last version is on the APPS menu, so any other keys that I didn't list
(besides ENTER) will not do anything.

*APPS Menu-  This takes place of the shortcuts/special bets.  Just 
press APPS while on the bet screen to see a pop-up menu of what
you can do.  Also, you can press APPS in game to see this menu, 
minus the special bets. Press ESC to do nothing on either menu
and to get back to where you were.

*Hand Heiarchy (in order of worst hand to best hand):
 *Nothing-Having none of the following hands
 *Pair-Get Two of the same card (e.g. 2,2)
 *Two Pair-Get two pairs (e.g. 2,2,3,3)
 *Three of A Kind- Three of the same card (e.g. 3,3,3)
 *Straight- All five cards go up in numerical order (e.g. 2,
  3,4,5,6)
 *Flush- All five cards have the same suits (e.g. 5 hearts)
 *Full House- Having three of a kind of one card and a 
  pair of the other (e.g. 3,3,3,2,2)
 *Four Of A Kind- Having four of the same card(4,4,4,4)
 *Straight Flush- A straight with with all same suits 
  (i.e. 2,3,4,5,6 and all hearts)
 *Royal Flush-A straight consisting ONLY of these five
  cards: 10, Jack, Queen, King, Ace, and all have to be
  of the same suit
 *Five Of A Kind- Having five of the same card (5,5,5,5,5)
-------------------------------------------------------------------------------------------
Scoring:  When betting in virtual poker, it is simulating
the act of putting credits into the machine.  That means
that once the money is put in it is gone from your total. 
An example: You have 100 credits.  You put 50 credits
into the machine to play.  You end up with a pair, which 
earns you 2* your original bet, in this case 100 credits.
You now have a total of 150 credits now, because you
spent 50 credits and earned 100.  Winnings for each hand:
*Nothing-0
*Pair-2* your bet 
*Two Pair-3* your bet
*Three of a Kind-4* your bet
*Straight-5* your bet
*Flush-6* your bet
*Full House-8* your bet   
*Four of a Kind-10* your bet
*Straight Flush-15* your bet
*Royal Flush-25* your bet          
*Five of a Kind-25* your bet
---------------------------------------------------------------------------------------------
Future Versions(?) may or may not include:
*Anything that comes to mind
---------------------------------------------------------------------------------------------  
Bugs: None known
---------------------------------------------------------------------------------------------
Thanks To:  *Jason Ho-  His Card Game Maker program was
                                     provided the graphics of the cards, suits
                                     (minus the diamonds), and backs #1,7,
                                     and 8.
                     *Charles Evans-  He created the new diamond, the
                                                   joker's, back #2, suggested the "Max
                                                   Bet" option, suggested the number in
                                                   the corner in HSM mode, beta-tested
                                                   the program, and inspired me to 
                                                   program again by bothering me to fix
                                                   a simple Black Jack bug.
                     *William Hibdon-  He created the zrand() program
                                                    for the new deck system, beta-tested
                                                    the program, and provided assistance
                                                    whenever I need it.
                     *The calcgames.org reviewers for giving my Black Jack
                      two great reviews (which made me feel nice inside :-) )
                     *YOU-  For taking a chance on a BASIC game (and finding
                                 out that not all BASIC games have to suck) and also
                                 (hopefully) writing me a letter about bugs and
                                 comments or reviewing/rating my program.
------------------------------------------------------------------------------------------------
History:  
5.0-*Added Jokers
       *Added Unlockable Backs
       *Added the "Max Bet" Option in the APPS Menu
       *Added a little number to the bottom corner of the screen in
        HSM mode (to tell what turn you're on).
       *Added ability to press ESC and exit the game from the main
        menu
       *Added the ability to press ESC when picking a value for 
        a wild card so you can look at your hand before choosing
       *Added "Loading Hand" text while the hand is being created
       *Added a contact dialog upon exiting the program
       *Added "-----" for non-won cheats (in the Cheats toolbar)
       *Added a screen invert when you get "Nothing"
       *Added screen "flashing" at the end of HSM
       *Added changing losing comments if you lose all your money
       *Added to the opening animation (random card suits, screen
          effects at the end, etc.)
       *Added a little anti-cheating protection
       *Fixed bet error entering bug (would delete your front number)
       *Fixed turn wasted bug by going to APPS menu and pressing
        ESC
       *Fixed turn wasted bug by a bad bet
       *Fixed nothing entered in the bet screen bug that crashed the
        game
       *Fixed a suit display problem (were not centered in the cards)
       *Fixed a bug in highlighting wild cards (would not highlight
          the whole card)
       *Changed the graphical display of the cards slightly (black outlines
        for the cards)
       *Changed the look of the Diamonds
       *Changed the scoring completely
       *Changed the high score's initial values
       *Changed the high score places by increasing them
         from 3 to 5
       *Changed the way cheats are added (like the backs, in numerical
        order
       *Changed "Credits" to "Chips"
       *Changed "Continue A Saved Game" to "Load A Game" in the
         main menu
       *Changed "Change" to "Toggle" (in the cheat toolbar)
       *Changed the last code's name to "Double Draw"
       *Changed the game file's names (e.g. "zc1" instead of
         "card1")
       *Speeded up bet screen typing
       *Speeded up the Main Menu cursor
       *Speeded up the Wild Card System
       *Speeded up the deck system (card picking much faster
          now)
       *Combined all the save lists into one matrix ("save")
       *Got rid of the special bets from the APPS menu
       *Increased the size of the bet screen box
       *Save file now archived for user convenience
       *Deletes a saved file after loading to prevent re-running
        the file over and over again       
        *Re-did and optimized some code
        *Put more code in zex() to prevent memory errors (and speed
         up gameplay)        

4.0-*Added Wild 2's
       *Added Five of a Kind
       *Added a little to the animation of the cards by having cards
        that are not held turn over
       *Added a little to the opening animation
       *Created zex() to prevent memory errors
       *Changed "Turn Real Deck OFF/ON" to "Real Deck=ON/
         OFF" in APPS menu

3.0- *Added option to have 2 decks
        *Added a new earnable cheat
        *Fixed bug where it took you to the records when you got
         the cheat for opening the game 25 times
        *Fixed bug where the game would tell you that you opened
         a new cheat every time you played a hand after 25
        *Fixed bug where going to the Apps menu from the bet 
         screen would take up a turn
        *Fixed bug where you could create a fresh deck even if
         Real Deck was turned off
         *Fixed bug where the game would freeze when it was trying
         to pick cards when Real deck was on
         *Fixed bug where you could save in free play mode, even 
          though no data was actually saved

2.0-  *Added a new betting screen
         *Added an APPS menu
         *Added earnable cheats
         *Added default high scores
         *Got rid of dialog betting option (because of new betting
           screen)
         *Got rid of shortcuts/special bets (becuase of apps menu)
         *Put Real Deck option on APPS menu
         *Replaced Options menu with Cheats (since there were
          no options left in it)
         *Fixed the statistic scoring
         *Actions (saving, real deck, fresh deck) can be changed
          ingame for both modes in APPS menu

1.0-First Release
--------------------------------------------------------------------------------------
Any Questions, Comments, Compliments, Criticisms,
Suggestions, Bugs, or Ideas?
E-mail Me at: Blink0072005@cox.net
                        Blink0072005@hotmail.com
AIM: DriveThruRec2005
MSN:  Blink0072005@hotmail.com

                            